home *** CD-ROM | disk | FTP | other *** search
/ Total NET Advanced Server 5.3 R1 / TotalNET Advanced Server v5.3 r1.iso / TAS / irix6_5 / TAS.idb / usr / share / catman / local / cat1 / tnmsgfmt.1.z / tnmsgfmt.1
Encoding:
Text File  |  1998-09-28  |  5.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. tnmsgfmt(1)                                           tnmsgfmt(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        tnmsgfmt  -  create  message  object  files  from portable
  9.        object files
  10.  
  11.  
  12. LLOOCCAATTIIOONN
  13.        TNHOME/usr/bin
  14.  
  15.  
  16. SSYYNNOOPPSSIISS
  17.        tnmsgfmt [-v] _f_i_l_e.xmsg
  18.  
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.        This command creates message object  files  from  portable
  22.        object  files -- those with the ".xmsg" extension -- with-
  23.        out changing the portable files. An ".xmsg" file  contains
  24.        messages displayed to users by system commands or applica-
  25.        tion programs.  You can edit these files and translate the
  26.        messages to any language supported by the system.
  27.  
  28.        All  ".xmsg"  files  have the same format.  Each file con-
  29.        tains one or more lines, and each line contains a  comment
  30.        or  a  statement.  A  comment  begins with a hash mark (#)
  31.        begins and ends with a new-line character. The  "tnmsgfmt"
  32.        command  ignores all comments. Statements follow this for-
  33.        mat:
  34.  
  35.               _d_i_r_e_c_t_i_v_e _v_a_l_u_e
  36.  
  37.        Each _d_i_r_e_c_t_i_v_e definition starts at the beginning  of  the
  38.        line, and white space -- either a space or a tab character
  39.        -- separates it from the _v_a_l_u_e definition. The _v_a_l_u_e vari-
  40.        able  consists of one or more quote-enclosed strings sepa-
  41.        rated by white spaces. Use any  of  the  following  direc-
  42.        tives:
  43.  
  44.               domain _d_o_m_a_i_n
  45.               msgid _m_e_s_s_a_g_e___i_d_e_n_t_i_f_i_e_r
  46.               msgstr _m_e_s_s_a_g_e___s_t_r_i_n_g
  47.  
  48.        For  the  "domain"  directive,  the value of _d_o_m_a_i_n should
  49.        correspond to the message file name. For example,  if  you
  50.        edit  messages for the "tnnlc_lowutils" domain, the direc-
  51.        tive should read "domain tnnlc_lowutils"  and  the  output
  52.        becomes the message file "tnnlc_lowutils.mo".
  53.  
  54.        The  "msgid"  directive  specifies  the value of a message
  55.        identifier associated with the directive that follows  it.
  56.        The  _m_e_s_s_a_g_e___i_d_e_n_t_i_f_i_e_r  variable  represents  the  target
  57.        string to use  at  retrieval  time.  Follow  each  "msgid"
  58.        directive  statement  with a "msgstr" directive statement.
  59.        Do not change the "msgid" lines, since the code uses  them
  60.        as  keys  to  locate the translated strings defined by the
  61.  
  62.  
  63.  
  64. tas-ss-5.3.0                1998/06/17                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tnmsgfmt(1)                                           tnmsgfmt(1)
  71.  
  72.  
  73.        "msgstr" lines. Message  strings  for  the  _m_e_s_s_a_g_e___s_t_r_i_n_g
  74.        variable   can   contain   any  of  the  following  escape
  75.        sequences:
  76.  
  77.               \n - new line
  78.               \t - tab
  79.               \v - vertical tab
  80.               \b - backspace
  81.               \r - carriage return
  82.               \f - form feed
  83.               \ - backslash
  84.               \" - double quotes
  85.               \ddd - octalbit pattern
  86.               \xDD - hexadecimal bit pattern
  87.  
  88.  
  89. OOPPTTIIOONN
  90.        -v             List duplicate message identifiers  without
  91.                       re-defining message strings.
  92.  
  93.  
  94. OOPPEERRAANNDD
  95.        _f_i_l_e           The  name  of  the portable object file you
  96.                       created using the directives listed in  the
  97.                       description above.
  98.  
  99.  
  100. EEXXAAMMPPLLEE
  101.        To  create  a message object file from the portable object
  102.        file "textfile.xmsg" and list  duplicate  message  identi-
  103.        fiers without re-defining message strings:
  104.  
  105.               tnmsgfmt -v textfile.xmsg
  106.  
  107.  
  108. SSEEEE AALLSSOO
  109.        tncmnames(1), tngettext(1)
  110.  
  111.  
  112.  
  113. NNOOTTEESS
  114.               Install  message  object  files  in the directory "
  115.             _T_N_H_O_M_E /usr/lib/locale_//_lm_as_ng_gs_[_/_c_h_a_r_s_e_t_/_]_"_, where  _T_N_H_O_M_E
  116.               represents     the    TotalNET    home    directory
  117.               "/var/opt/totalnet" or, for  AIX,  "/var/totalnet".
  118.               The  _l_a_n_g  variable represents the message language
  119.               defined for the LC_MESSAGES environment variable or
  120.               for the LANG environment variable, and _c_h_a_r_s_e_t rep-
  121.               resents the message character set defined  for  the
  122.               LC_CHARSET environment variable.
  123.  
  124.  
  125.               Messages can have any length; however, each line in
  126.               the ".xmsg" file can have no  more  than  MAX_INPUT
  127.  
  128.  
  129.  
  130. tas-ss-5.3.0                1998/06/17                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. tnmsgfmt(1)                                           tnmsgfmt(1)
  137.  
  138.  
  139.               (512) bytes.
  140.  
  141.  
  142.               Installing  message catalogs in the C locale serves
  143.               no purpose, since "tnmsgfmt" ignores them  for  the
  144.               sake of efficiency.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. tas-ss-5.3.0                1998/06/17                          3
  197.  
  198.  
  199.